home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / biz / dopus / HTTPlister.lha / HTTPlister.readme < prev    next >
Text File  |  1999-01-02  |  6KB  |  155 lines
  1.   *** Readme for setup & running of HTTPlister.rexx V1.8 ***
  2.  
  3.   V1.8 changes:
  4.  
  5.   Added a 'Date' column to the right of the 'Comment' column.
  6.  
  7.   Selecting the label for the 'Date' column, entries in the lister
  8.   can now be sorted into the same order as they were in the file
  9.   they came from. (The 'dates' are meaningless - generated for
  10.   sorting purposes only).
  11.  
  12.   The most downloaded files and the highest rated programs no longer
  13.   start with '!.' and '%.' they are recognized by thier dates now.
  14.   See below under the heading The lister.,.
  15.  
  16.   If 'Date:' is found in the header of the Aminet RECENT file then
  17.   that date is shown in the listers' drag bar along with 'Aminet
  18.   listing' or the list files' name.
  19.  
  20.   Added instructions to the HTTPlister.rexx header on how to use this
  21.   if you don't use a proxy.
  22.  
  23.   The rest of the archive is the same, so if you have V1.7 you only
  24.   need to replace the HTTPlister.rexx file to update to V1.8. (And
  25.   of course reset the variables again).
  26.  
  27.             -------------------------------
  28.  
  29.   You will need HTTPResume, also found on aminet (comm/www) for
  30.   this to work.
  31.   
  32.   Once you have done the small amount of setting up, outlined below
  33.   you will be able to list the entire contents of the Aminet RECENT
  34.   file in a Dopus lister (optionally minus the aminet file dirs you
  35.   don't want listed) and to select any number of files and download
  36.   them.
  37.   
  38.   You'll also be able to select/download and read readme files.
  39.   
  40. Downloading files.,
  41.    The initial download directory is RAM: as set by the variable 'DDir'.
  42.  
  43.    You download the files by clicking on them once in the lister and
  44.    then selecting the GoGet'em button.    (Or press the 'G' key)
  45.  
  46.    Alternatively you can Drag & Drop them into a destination lister.
  47.    That will cause that lister to be the new download directory.
  48.  
  49.    The directory for downloading files to can also be changed by
  50.    selecting the ChDLDir button.
  51.  
  52.    Because the most likely time to encounter download troubles is
  53.    during the downloading of large files with the posibility of
  54.    missing the smaller files, the selected files are downloaded from
  55.    smallest to largest.
  56.  
  57.    Downloaded files of the same name overwrite the ones in the
  58.    download directory.
  59.  
  60.    An HTTPdebug.log file is written to the download directory.
  61.  
  62. Readme files.,
  63.    To read the readme for a file hold down the SHIFT key and
  64.    DOUBLECLICK the file.
  65.  
  66.    Or hold down the SHIFT and Drag & Drop the file into a destination
  67.    lister, that will also make that lister the current download
  68.    directory - all future downloads will go there; that is until
  69.    there's another Drag & Drop to somewhere else.
  70.  
  71.    Only get ONE readme file at a time.
  72.  
  73. To get this going, pass a listing file to this script by.,
  74.    either selecting the listing file in a lister and then run this script
  75.    OR pass the listing file with it's path to this script as an argument
  76.    when running it.
  77.  
  78.    When you've finished with a listing you can get another listing into
  79.    the lister using the Load button in the lister or Drag & Drop a
  80.    listing file into the lister or run this script again passing the
  81.    listing file to it as mentioned.
  82.  
  83.    If you run this script from a Dopus menu etc. set the flag
  84.     Run asynchronously.
  85.  
  86. The lister.,
  87.    Each button in the lister has a keyboard alternative as per the
  88.    first character of the text in each button.
  89.  
  90.    By selecting either of the listers column labels 'Name' or 'Comment'
  91.    the list can be sorted either by file name or by aminet directory.
  92.  
  93.    Selecting the 'Date' label in the lister gets all the lines sorted in
  94.    the same order as they were in the file they came from. (The 'dates'
  95.    are meaningless - generated for sorting purposes only).
  96.  
  97.    It is actually the 'time' part of the date field that gets incremented,
  98.    the dates remain constant.
  99.  
  100.    o The most downloaded files from Aminet during the week have the date:
  101.      22-Feb-88.
  102.  
  103.    o The highest rated programs during the week have the date:
  104.      30-Mar-98.
  105.  
  106.    o The rest have the date:
  107.      01-Jan-78.
  108.  
  109.    Message of the day; if there is one, gets displayed as list is loaded.
  110.  
  111.    The download directory can be changed by selecting the ChDLDir button.
  112.  
  113.    The download directory changes when you download by Drag & Drop.
  114.  
  115.    Downloaded (read) readme's are left in the download directory.
  116.  
  117.    Files not found (except the readme's) are left selected.
  118.  
  119.    Select the Search button to search the lister for any string.
  120.  
  121.    Unselect de-selects all selected entries.
  122.  
  123.    If HTTPresume is aborted before the file has finished being downloaded
  124.    you will just have to try again or use HTTPresume for what it was
  125.    designed for. Read HTTPresume docs for all about that.
  126.  
  127.  
  128. *** Setting up **
  129.   
  130.   o  Copy the file in the  Button drawer to the Dopus5:Button drawer.
  131.   o  Copy the files in the Image  drawer to the Dopus5:Image drawer.
  132.   o  Copy the file in the  ARexx  drawer to the Dopus5:ARexx drawer.
  133.  
  134.   o  READ THE HEADER IN HTTPlister.rexx for more info as THERE ARE
  135.      VARIABLE VALUES TO BE SET there.
  136.  
  137.   o  Edit the FilterOut string in HTTPlister.rexx.. the aminet
  138.      file dirs you don't want listed.
  139.  
  140.   I have included the file 'aminet_TREE' in this archive to refer to
  141.   when compiling the list of aminet file dirs to filter out.
  142.  
  143.   I have also included the ARexx script 'YAM2HTTPlister.rexx' for getting
  144.   a subscribed RECENT file loaded into the lister from YAM.
  145.   
  146. Note!
  147.  * This is strictly USE AT YOUR OWN RISK.
  148.  * This has only been tested with Directory Opus 5.661 Magellan and
  149.  * HTTPResume 1.3.
  150.  * The names listed in the lister are only pseudo-files and can't be
  151.  * treated as you would other file names in normal listers. Only apply
  152.  * the actions that I outline and it should all work OK.
  153.   
  154.                              ******
  155.